<html>
<head>
	<title>Jive Forums Documentation -- Installation Guide</title>
	<style>
		BODY,TD {
			font-family : verdana,arial,helvetica,sans-serif;
			font-size : 10pt;
		}
		.pageHeader { 
			font-family : arial,helvetica,sans-serif;
			font-size : 12pt;
			font-weight: bold;
		}
		.path {
			color="#003399";
		}
	</style>
</head>
<body>
<span class="pageHeader"><a name="introduction">Installation Guide</a></span>
<p>
Jive Forums is a powerful online discussion tool for websites. This document 
will guide you through installing the application. For a full list of features
and more information, please visit the Jive Software website: 
<a href="http://www.jivesoftware.com/" target="_top">http://www.jivesoftware.com</a>

<p>

In order to install Jive Forums, you'll need to a server environment that meets 
the following requirements:
<ul>
  <li>A servlet engine with JSP 1.1 and Servlet 2.2 support.
  <li>JDK 1.2 or later.
  <li>A database supported by Jive with a robust JDBC driver. Supported
  	databases and recommended JDBC drivers are detailed in the database
	documentation below.
</ul>
<p>

<b><a name="overview">Installation Overview</a></b><p>
To complete the installation of Jive Forums, you'll need to perform each of the following steps:
<ol>
  <li><a href="#appserver">App Server</a> - setup your application server by 
  	installing the application files and JDBC driver.
  <li><a href="#database">Database</a> - prepare your database for Jive.
  <li><a href="#tools">Setup and Admin Tools</a> - use the web-based setup tool 
  	to establish a database connection and to setup the administrator account.
	You'll then use the admin tool to create and manage forums.
</ol>

<p>
<b><a name="appserver">1. Application Server Setup<a></b><p>
Jive Forums should be installed as a web application in a Servlet 2.2 or later
application server. Please consult your server documentation if you are not
familiar with setting up web applications.
<p>
First, create a new web application. You may wish to call it <tt>jive</tt>, as
we will below.
<p>
Next, copy the contents of the <tt>application</tt> 
folder of this distribution into the web application directory you just created. 
The directory structure should now look something like the following (many
directories omitted for brevity):

<pre>
jive
   /admin
   /WEB-INF
         /classes
         /lib
         /jiveHome
</pre>

Next, edit the <tt>jive_init.properties</tt> that can be found in your 
<tt>WEB-INF/classes</tt> directory with the text editor of your choice. Follow 
the instructions in
that file to set the path to your <tt>jiveHome</tt> directory (installed at
<tt>WEB-INF/jiveHome</tt>).

<p>
The Jive Forums web application should now be properly configured. Restart your
application server as necessary and then proceed to the next installation step.

<p>
<b><a name="database">2. Setting Up the Database<a></b>
<p>
Jive Forums uses a database to store forum content. To setup your database you must
load the appropriate database schema. 
You can find schemas in the "database" directory of this distribution.
View the <a href="database.html">database setup</a> documentation to learn how to 
install the schemas and JDBC drivers. 
<p>
Complete the database steps outlined in the database setup documentation before
proceeding further.

<p>
<b><a name="tools">3. Setup and Admin Tools<a></b>
<p>
After completing the above steps, you should be ready to run the setup tool. 
Point your web browser to the location on your webserver where you installed the 
admin skin. For example: http://www.[yourserver].com/jive/admin/setup
<p>
The setup tool will guide you through the final steps of getting Jive up and 
running. Once setup is complete, you will be redirected to the admin tool, which 
can be found at something similar to http://www.[yourserver].com/jive/admin. 
Use the admin tool to create and manage forums, users, and groups.
<p>

</ul>

<p>

<span class="pageHeader"><a name="use">Using Jive</a></span><p>

Once you have completed the installation and setup of Jive, the admin tool will 
let you create and administer forums, users, and groups. End-users can browse
the forums you've setup by visiting a URL similar to: http://www.[yourserver].com/jive

<p>

<span class="pageHeader"><a name="support">Support</a></span><p>

Please visit the <a href="http://www.jivesoftware.com" target="_top">
Jive Software website</a> to post bug reports and ask 
questions in the forums. If you have purchased a version of Jive Forums that
includes a support plan, use the contact info that was provided when
you made the purchase.

<p><span class="pageHeader"><a name="source">Source Code</a></span><p>

The Jive Forums source code is available via CVS. Find more information
in the developer area of Jive Software website: 
<a href="http://www.jivesoftware.com/developer" target="_new">
http://www.jivesoftware.com/developer</a>.

<p>

The extensive <a href="../javadoc/index.html" target="_new">Javadoc documentation</a> 
included with this distribution can be used as a class reference.
  
<br><br>
<center>
<hr size="1" width="60%" color="#666666">
<font size="-2" face="verdana" color="#666666">
Copyright &copy; CoolServlets Inc., 2000-2001</font>
</center>

</body>
</html>
